home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / 3mhs099.zip / 3MHS.DOC < prev    next >
Text File  |  1992-03-18  |  39KB  |  1,352 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                              3+MHS Gateway
  9.  
  10.  
  11.  
  12.                              The 3+MAIL/MHS
  13.  
  14.                          Connectivity Solution
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                               Version 0.99
  21.  
  22.                              March 18, 1992
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.           Copyright (c) 1992 by Brian Dluhy, Howard Kapustein
  33.  
  34.                           All Rights Reserved
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96. 3+MHS Gateway            -2-                      Version 0.99
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103. 1. 3+MHS Shareware Software License
  104.  
  105. This version of 3+MHS Gateway is NOT public domain or free software, but
  106. is being distributed as "shareware" for EVALUATION PURPOSES ONLY.
  107.  
  108. 1.1. Usage Restrictions
  109.  
  110. The author(s) grants a limited license to individuals to use this
  111. shareware software for a 30-day evaluation period on a private, non-
  112. commercial basis, for the express purpose of determining whether 3+MHS
  113. Gateway is suitable for their needs. At the end of this 30-day
  114. evaluation period, the individual must either purchase a license from
  115. the author(s) for continued use of the program, or discontinue using
  116. 3+MHS Gateway.
  117.  
  118. What does this mean? If you use this program on a continued basis, you
  119. must purchase a license for its use. 3+MHS Gateway is NOT free, and we
  120. are not giving away free copies. We are giving you the opportunity to
  121. try it before paying for a license for continued use. It is that simple.
  122. Try it. Then either pay for it, or quit using it.
  123.  
  124. Paying for a license to continue using the software product is not only
  125. required, but also allows the author(s) to provide support and updates,
  126. and continue to provide professional-quality software at reasonable
  127. prices. Licensed users receive printed documentation and a version of
  128. the program that does NOT prefix messages transferred with shareware
  129. reminder text. Registration of the licensed copy allows the registered
  130. user to receive technical support (by phone, BBS, mail, or various
  131. electronic services such as CompuServe), and makes them eligible for
  132. discounts on future versions.
  133.  
  134. Purchasing a license for 3+MHS Gateway entitles you to use the program
  135. in conjunction with a single MHS and/or 3+MAIL server. If you would like
  136. a multiple-use (site) license, please contact the author(s) for details.
  137.  
  138. 1.2. Distribution, Copying Restrictions
  139.  
  140. Individuals are granted a limited license to copy the SHAREWARE version
  141. of 3+MHS Gateway only for the trial use of other individuals and subject
  142. to the above limitations. This license DOES NOT include distribution or
  143. copying of this software package:
  144.  
  145.  1.  In connection with any other product or service;
  146.  
  147.  2.  For general use within a company, institution, or agency;
  148.  
  149.  3.  For any consideration or 'disk fee'; or
  150.  
  151.  4.  In modified form (i.e., any distribution that does not include ALL
  152.    FILES supplied by the author(s) with the shareware version of 3+MHS
  153.    Gateway, WITHOUT ALTERATION. This also prohibits distribution of all
  154.    or portions of the documentation in printed form.)
  155.  
  156.  
  157.  
  158.  
  159. 3+MHS Gateway            -3-                      Version 0.99
  160.  
  161.  
  162.  
  163.  
  164.  
  165. Operators of electronic bulletin board systems (Sysops) are permitted
  166. and encouraged to post the shareware version of 3+MHS Gateway for
  167. downloading by their users, as long as the above conditions are met.
  168. Though a fee may be charged for BBS access, NO FEE may be charged to
  169. specifically access or download the 3+MHS Gateway shareware files.
  170.  
  171. Non-profit computer-related User Groups may distribute the shareware
  172. version of 3+MHS Gateway provided the above conditions are met. However,
  173. such User Groups MAY charge a NOMINAL fee to cover the cost of the disk
  174. and copying of the software.
  175.  
  176. Disk vendors MUST obtain written permission from the author(s) before
  177. distributing the shareware version of 3+MHS Gateway. Certain
  178. restrictions apply. Generally, permission is granted. Call or write for
  179. further details.
  180.  
  181.  
  182.  
  183. 2. Warranty Disclaimer
  184.  
  185. THE SHAREWARE VERSION OF 3+MHS GATEWAY IS SUPPLIED "AS IS" AND WITHOUT
  186. ANY WARRANTY. TO THE EXTENT PERMITTED UNDER APPLICABLE LAW, THE
  187. AUTHOR(S) DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
  188. NOT LIMITED TO, ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A
  189. PARTICULAR PURPOSE. SPECIFICALLY, THE AUTHOR(S) MAKES NO REPRESENTATION
  190. OR WARRANTY THAT THE SOFTWARE IS FIT FOR ANY PARTICULAR PURPOSE.
  191.  
  192. THE AUTHOR(S) SHALL NOT BE LIABLE FOR ANY DAMAGES RESULTING FROM THE USE
  193. OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, LOSS OF PROFIT, DATA OR
  194. USE OF THE SOFTWARE, OR SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES OR
  195. OTHER SIMILAR CLAIMS, EVEN IF THE AUTHOR(S) HAS BEEN SPECIFICALLY
  196. ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE
  197. EXCLUSION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE FOREGOING
  198. LIMITATION MAY NOT APPLY TO YOU.
  199.  
  200.  
  201.  
  202. 3. Ordering Information
  203.  
  204. 3.1. Licensing
  205.  
  206. Purchasing a license for 3+MHS Gateway allows you to use the product on
  207. a regular and/or continuing basis. Registration of your licensed copy of
  208. 3+MHS Gateway entitles you to technical support from the author(s) and
  209. discounts on updates.
  210.  
  211. With your purchase, you will receive: a licensed copy of 3+MHS Gateway
  212. V0.99 with a 90-day limited warranty and printed, bound documentation.
  213.  
  214. In addition, your registration entitles you to a free upgrade to Version
  215. 1.00 when available.
  216.  
  217. ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT NOTICE.
  218.  
  219. 3.2. Site Licenses and Quantity Purchases
  220.  
  221.  
  222. 3+MHS Gateway            -4-                      Version 0.99
  223.  
  224.  
  225.  
  226.  
  227.  
  228. All corporate, business, government or other commercial, public or
  229. private users of 3+MHS Gateway must be licensed. Quantity discounts as
  230. well as site (multi-user) licensing is available. Please call or write
  231. for more information.
  232.  
  233. If you have special requirements, or need customization, please feel
  234. free to submit them in writing. You may request a license for:
  235.  
  236.    Fixed number of copies. See the discount schedule;
  237.  
  238.  
  239.    Unlimited number of copies. The fee is $2,500;
  240.  
  241.    Customization of messages and documentation. An additional fee may be
  242.    required depending on the extent of changes;
  243.  
  244.    Permission to distribute within your organization;
  245.  
  246. The fee for a license depends on the estimated number of servers that
  247. will use 3+MHS Gateway. To use the discount schedule below, estimate the
  248. total number of MHS servers you plan to use 3+MHS Gateway in conjunction
  249. with:
  250.  
  251.  
  252.                  Number of MHS servers     Price per
  253.                         (copies)              copy
  254.  
  255.                            1                $295.00
  256.                           2-3               $275.00
  257.                           4-6               $250.00
  258.                           7-9               $225.00
  259.                        10 and up            $200.00
  260.  
  261. Please contact the author(s) for site license prices.
  262.  
  263. Regardless of quantity, only one set of materials will be sent to you.
  264. You may then make as many copies as your are licensed. Upgrades will be
  265. made available upon request.
  266.  
  267. Reseller inquiries are welcome.
  268.  
  269. 3.3. Orders Outside the U.S./Canada/Mexico
  270.  
  271. Please send a check drawn on a US bank payable in US dollars. Please add
  272. $5 for to cover overseas shipping.
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284. 3+MHS Gateway            -5-                      Version 0.99
  285.  
  286.  
  287.  
  288.  
  289.  
  290. 3.4. Single License Order Form
  291.  
  292.  
  293. Remit to:  Brian Dluhy                            Order Form  #9203-OF01
  294.            PO BOX 376
  295.            Devault, PA  19432  USA
  296.  
  297.              ***  3+MHS Gateway version 0.99, March 1992  ***
  298.                    * Single-Server License Order Form *
  299.  
  300. NOTE: We offer quantity discounts and multiple-user licenses.
  301.       Call for details.
  302. ------------------------------------------------------------------------
  303. Send me:
  304.  
  305. ____ 3+MHS Gateway with Printed Manual.......... @ $295.00 ea  $ ______
  306.      Includes single-server licensed copy of software (Version
  307.      0.99) on dual (5.25/3.5) media, 90-day limited warranty,
  308.      spiral-bound indexed manual, free upgrade to version
  309.      1.00, low-cost upgrades.
  310.  
  311. SHIPPING (each copy)... US/Canada/Mexico: $3;  Overseas: $10   $ ______
  312.  
  313.                                                      SUBTOTAL  $ ______
  314.  
  315. Pennsylvania Residents please add Sales Tax ...........  @ 6%  $ ______
  316.  
  317.                          TOTAL (U.S. Funds drawn on U.S. Bank) $ ______
  318.  
  319. Payment by:  ( )CHECK   ( )MONEY ORDER
  320.  
  321. Name: _____________________________________________________________
  322.  
  323. Company (ONLY if company address):_________________________________
  324.  
  325. Address: __________________________________________________________
  326.  
  327.        : __________________________________________________________
  328.  
  329.        : __________________________________________________________
  330.  
  331. Voice Day Phone: ______________________ Evening: __________________
  332.  
  333.  
  334. PRICES SUBJECT TO CHANGE WITHOUT NOTICE.  Call to confirm current
  335. prices.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346. 3+MHS Gateway            -6-                      Version 0.99
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353. 4. Credits
  354.  
  355. 4.1. About the Authors
  356.  
  357. Brian Dluhy
  358.  
  359. A long time 3Wizard and recent CNE candidate, I first became involved
  360. with 3Com and networks at SMS (Shared Medical Systems) in 1984.  At SMS,
  361. I have been involved with supporting our 3Com clients as well as our
  362. large internal 3Plus network.  I was a member of the 3Wizard Council as
  363. well as a director of our local 3Com User Group.  Since that fateful day
  364. last January, I have been been working on migration issues for our
  365. clients as well as our internal network.
  366.  
  367. Howard Kapustein
  368.  
  369. After graduating Rensselaer Polytechnic Institute in May, 1989 (B.S in
  370. Computer Science , minor in Accounting), I joined the ranks of SMS
  371. (Shared Medical Systems) in Malvern, PA in the PC development
  372. department. Since then I've had the opportunity to delve into Microsoft
  373. Windows, OS/2 (2.0!), C++, object-oriented analysis and design, Novell
  374. NetWare, and communications in general. Replacing my old clunker PC with
  375. a Gateway 2000 386/33 has helped my pursuit of consulting and
  376. programming on the side (hint, hint, especially in C/C++ and DOS).
  377. Author of several shareware packages, I still putter when I get a chance
  378. (and the Mrs. let's me :-)
  379.  
  380. 4.2. Acknowledgements
  381.  
  382. Infinite thanks to Kim for keeping me sane and happy, and letting me
  383. putter at all hours of the day (and night).
  384.  
  385. Robert Blacher, Sysop of Computer Connections (202-547-2008), for
  386. running an excellent BBS.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409. 3+MHS Gateway            -7-                      Version 0.99
  410.  
  411.  
  412.  
  413.  
  414.  
  415. 5. Introduction
  416.  
  417. The 3+MHS Gateway is designed to provide seamless electronic mail
  418. connectivity between 3Com 3+MAIL and Novell Message Handling Service
  419. (MHS) systems and users. All major functionality of the mail systems is
  420. supported, as well as numerous minor features (where possible).
  421.  
  422. Why version 0.99?
  423.  
  424. Although extensive testing of all 3+MHS Gateway functionality has been
  425. performed, a complete and thorough test of all probable configurations
  426. is not possible by the author(s). [Microsoft had 3,000+ beta testers for
  427. DOS 5.0 and still missed a few 'features'.] The author(s) feel the
  428. current version of 3+MHS Gateway is firmer and more reliable than many
  429. commercial packages, but a "post-beta" or "preliminary release" period
  430. is felt to be in the best interest of you, the client.
  431.  
  432. Feedback is welcome. Suggestions to make 3+MHS Gateway more robust,
  433. functional and/or easy to use can be passed on to the author(s) via
  434. mail, phone and/or electronic services.
  435.  
  436.  
  437.  
  438. 6. Features
  439.  
  440. The 3+MHS Gateway provides complete connectivity for 3Com 3+MAIL and
  441. Novell MHS systems and users. Features include:
  442.  
  443.    Runs as a true MHS gateway *OR* as a standalone process
  444.    (Currently the *ONLY* native 3+MAIL/MHS gateway);
  445.  
  446.  
  447.    Multiple addressing options for flexible routing of messages;
  448.  
  449.    Supports all major 3+MAIL and MHS functionality including carbon
  450.    copy, attachments, registered mail, and non-delivery notifications;
  451.  
  452.    Optional Blind Carbon Copy support from MHS to 3+MAIL users;
  453.  
  454.    DOS 5.0 aware! Can use available high memory to ease RAM cram;
  455.  
  456.    Optional usage logging to disk for later review;
  457.  
  458.    Extra DaVinci EMail 1.x compatibility;
  459.  
  460. 3+MHS Gateway incorporates many small touches to enhance your
  461. productivity by performing its job in as seamless a manner as possible.
  462.  
  463.  
  464.  
  465. 7. System Requirements
  466.  
  467. The 3+MHS Gateway has the following requirements:
  468.  
  469.  
  470. 3+MHS Gateway            -8-                      Version 0.99
  471.  
  472.  
  473.  
  474.  
  475.  
  476.      DOS 3.1+
  477.  
  478.      256K available memory
  479.  
  480.      3Com 3+MAIL 1.3.1+
  481.  
  482.      Novell MHS 1.5+
  483.  
  484.      Concurrent NetWare MHS directory and 3+MAIL access (see below)
  485.  
  486.  
  487.  
  488. NetWare MHS (Directory) Access:
  489.  
  490.  3+MHS Gateway is written in compliance with Novell's guidelines for
  491.  writing MHS gateways. All message transfers through MHS are
  492.  accomplished by reading and writing files in specific subdirectories.
  493.  Thus, 3+MHS requires access to NetWare file services.
  494.  
  495. 3+MAIL (XNS) Access:
  496.  
  497.  3+MHS Gateway relies on CMAIL.EXE to perform all 3+MAIL transfers. The
  498.  CMAIL program requires the XNS protocol to be available. Thus, 3+MHS
  499.  Gateway requires the XNS protocol loaded in memory.
  500.  
  501. Several options are available to provide concurrent access to NetWare
  502. and 3+MAIL resources:
  503.  
  504.    3Com 3+Open/NetWare Coexistence
  505.    This product allows 3+Open users to access NetWare resources. To use
  506.    this product with 3+MHS Gateway, load the XNS protocol stack and the
  507.    NetWare coexistence software.
  508.  
  509.  
  510.    Microsoft LAN Manager/NetWare Coexistence
  511.    This product allows LAN Manager users to access NetWare resources.
  512.    Configuration requirements are identical to 3Com's 3+Open/NetWare
  513.    Coexistence: XNS protocol and NetWare software. [The XNS protocol can
  514.    be found in the Global Upgrade LAN Package (GULP) or the 3+ Upgrade
  515.    Pack, available from Microsoft.]
  516.  
  517.    Novell 3+/NetWare Coexistence
  518.    This product allows 3+/3+Open users to access NetWare resources. To
  519.    use this product with 3+MHS Gateway, load the XNS protocol stack and
  520.    the NetWare software. [Availability unknown: Novell is not yet
  521.    shipping this product.]
  522.  
  523.    OS/2 2.0 ???
  524.    An OS/2 2.0 workstation with NetWare file access (via the NetWare
  525.    Requester for OS/2) and XNS access (via 3Com XNS drivers in a Virtual
  526.    DOS Machine) should provide the services required by 3+MHS Gateway.
  527.    Specific configuration details are as yet unknown. Call for more
  528.    information. [Availability imminent: IBM is scheduled to ship OS/2
  529.    2.0 by March 31, 1992.]
  530.  
  531.  
  532. 3+MHS Gateway            -9-                      Version 0.99
  533.  
  534.  
  535.  
  536.  
  537.  
  538. NOTE: One of these options is required at the workstation running 3+MHS
  539. Gateway. All other workstations can load their normal software.
  540.  
  541.  
  542.  
  543. 8. Installation
  544.  
  545. Actual installation of 3+MHS Gateway is a relatively simple and painless
  546. operation. The most complicated steps involve configuring 3+MAIL and
  547. MHS, particularly adddressing, to operate compatibly. [An unfortunate
  548. reality in today's marketplace of minimal electronic mail standards for
  549. the PC.]
  550.  
  551. The specific steps encompass:
  552.  
  553. 1. Add 3+MHS Gateway as a MHS gateway
  554.  
  555. 2. Add 3+MHS Gateway as a 3+MAIL gateway
  556.  
  557. 3. Install the distributed 3+MHS Gateway software
  558.  
  559. 4. Configure MHS addresses to be compatible with 3+MAIL
  560.  
  561. 5. Configure 3+MAIL addresses to be compatible with MHS
  562.  
  563. Steps 4 and 5 may be optional, depending on the 3+MHS Gateway addressing
  564. schemes you choose and your existing mail addresses.
  565.  
  566.  
  567.  
  568. 8.1. Adding 3+MHS Gateway as a MHS Gateway
  569.  
  570. To define a gateway on an MHS server, the following steps should be
  571. taken:
  572.  
  573. 1.   From the Main menu, select Manage Directories:
  574.  
  575.            Manage Directories
  576.            Manage Connections
  577.            MHS utilities
  578.            Set up Transport Server
  579.  
  580.                                 <Done>
  581.  
  582.            Index: Press <?>     Help: Press <F1>
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594. 3+MHS Gateway            -10-                     Version 0.99
  595.  
  596.  
  597.  
  598.  
  599.  
  600. 2.   From the DIRECTORY MANAGER menu, select routes to workgroups, hosts
  601.      and gateways under the Review, add, modify or delete option section.
  602.  
  603.             D I R E C T O R Y      M A N A G E R
  604.  
  605.            Set up:
  606.             This host
  607.  
  608.            Review, add, modify, or delete:
  609.             names of users at this host
  610.             routes to workgroups, hosts and gateways
  611.             user routes
  612.             names of affiliated workgroups
  613.  
  614.                                 <Done>
  615.  
  616.  
  617. 3.   From the next menu, select Add entry:
  618.  
  619.            Review another list
  620.            View current list
  621.            Copy list to file
  622.  
  623.            Add entry
  624.            Modify entry
  625.            Delete entry
  626.  
  627. 4.   From the next menu, select Define a gateway:
  628.  
  629.            Define route to a workgroup or host reached
  630.           via:
  631.             telephone call TO that remote host
  632.             telephone call FROM that remote host
  633.             intermediary workgroup, host or gateway
  634.             internet path
  635.            Define a gateway
  636.  
  637.            Index: Press <?>    Help: Press <F1>
  638.  
  639.  
  640. 5.   The following menu prompts for the gateway's definition:
  641.  
  642.                       A GATEWAY
  643.  
  644.             Host name:
  645.            Description:
  646.          Gateway version:           64
  647.       Gateway commands:
  648.  
  649.                                            <Done>
  650.  
  651.       Index: Press <?>                     Help: Press <F1>
  652.  
  653.  Enter the following information:
  654.  
  655.  
  656. 3+MHS Gateway            -11-                     Version 0.99
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                       A GATEWAY
  663.  
  664.             Host name:              3MHS
  665.            Description:             3+Mail/MHS Gateway
  666.          Gateway version:           70
  667.       Gateway commands:             3+MHS command line
  668.      options
  669.  
  670.                                            <Done>
  671.  
  672.       Index: Press <?>                     Help: Press <F1>
  673.  
  674.  
  675.  The italicized text is optional. You may enter any Description you
  676.  like, and the Gateway commands should be selected for your particular
  677.  configuration. See Section 10. Command Line Options for the list of
  678.  3+MHS optional available.
  679.  
  680.  
  681. 8.2. Adding 3+MHS as a 3+Mail Gateway
  682.  
  683. To register a gateway in the Name Service, the following steps should be
  684. taken:
  685.  
  686. 1. Create a domain with a name that suggests the target mail system,
  687.  e.g. DISOSS. This domain should be defined to be on the network where
  688.  the gateway will reside. If done for 3+MAIL internetwork, the DISOSS
  689.  domain must exist on each network where gateway service is to be
  690.  available. In other words, a single gateway PC can serve a large
  691.  internet. There must be no real 3+Mail users in the gateway domain.
  692.  
  693. 2. Create a user in that domain, with the name _GATEWAY. The gateway
  694.  user must be registered for mail service, but need not have Share
  695.  service. Do not include the gateway user in any groups. Since logging
  696.  as the gateway user gives access to all outbound mail, it is a good
  697.  idea to assign a difficult-to-remember password to the gateway user.
  698.  For the internet case, it is not necessary to define a gateway user on
  699.  each network. 3+Mail will forward the message to the network where the
  700.  gateway domain exists, and it will be delivered to the gateway user's
  701.  inbox on that network, through the normal store-and-forward process.
  702.  
  703. 3. If any foreign users are defined in the gateway domain, they must not
  704.  be registered for 3+Mail service.
  705.  
  706. 4. (This step is optional, and relates to the curly brackets naming
  707.  discussed below.) Create a property for users in the name service or,
  708.  in the internetted case, in each name service in the network, called
  709.  Mail Address. Its property should be 50001. Here are the responses for
  710.  each of the prompts from 3N AddProp 50001:
  711.  
  712.      Property Type (S) ? <return>
  713.      Property Name? "Mail Address"  (name actually doesn't matter)
  714.      Property Description? (fill in, or leave empty)
  715.      Property Length? 200
  716.  
  717.  
  718. 3+MHS Gateway            -12-                     Version 0.99
  719.  
  720.  
  721.  
  722.  
  723.  
  724.      Property Format (String)? <return>
  725.      Primary Property to add to? "user"
  726.      Primary Property to add to? <return>
  727.  
  728.  
  729.  
  730. 8.3. Installing 3+MHS Software
  731.  
  732. To install the 3+MHS Gateway as a true MHS gateway, the following steps
  733. should be taken:
  734.  
  735. 1. Copy all files from the 3+MHS Gateway distribution disk to the
  736.  appropriate gateway subdirectory (MHS\MAIL\GATES\3MHS\PUBLIC).
  737.  
  738. NOTE: MHS represents the root MHS subdirectory. For example, if the MHS
  739. directory is accessed via F:\MHS, the above path would be
  740. F:\MHS\MAIL\GATES\3MHS\PUBLIC.
  741.  
  742. 2. Create the 3+MAIL work file subdirectory
  743.  (MHS\MAIL\GATES\3MHS\3MAIL\IN and MHS\MAIL\GATES\3MHS\3MAIL\OUT).
  744.  
  745. 3. Using any text editor, edit the file 3MHS-IN.BAT and change x: in
  746.  line 5 (CMAIL /ra x:\MHS\MAIL\GATES\3MHS\3MAIL\IN) to point to your
  747.  MHS drive.
  748.  
  749. 4. Using any text editor, edit the file 3MHS-OUT.BAT and change x: in
  750.  line 13 (FOR %%F IN (x:\MHS\MAIL\GATES\3MHS\3MAIL\OUT\*.MSG)...) to
  751.  point to your MHS drive.
  752.  
  753. Make sure CMAIL.EXE is accessible to these batch files. If CMAIL.EXE is
  754. not in your PATH, modify 3MHS-*.BAT and SEND1.BAT to run CMAIL via an
  755. explicit pathname (e.g. D:\3MAIL\CMAIL.EXE...).
  756.  
  757. The installation batch file (3MHSINST.BAT) will automate steps 1 and 2.
  758.  
  759. To run 3+MHS Gateway as a standalone process, copy all distribution
  760. files to a subdirectory and invoke the 3MHS-IN.BAT and 3MHS-OUT.BAT
  761. files appropriately.
  762.  
  763.  
  764. 8.4. Addressing 3+MAIL Users from MHS
  765.  
  766. Although 3+MAIL supports a standard 3-level addressing scheme
  767. (name:domain:organization), MHS only supports a 2-level addressing
  768. scheme (name@workgroup). How you configure MHS depends on the level of
  769. 3+Mail addressing you require.
  770.  
  771. 3+MHS Gateway provides the following address conversions from MHS to
  772. 3+MAIL via the -M option:
  773.  
  774.  '1'      - Non-SMF address only
  775.  
  776.  '2'      - Non-SMF address if available, else SMF address
  777.  
  778.  
  779.  
  780. 3+MHS Gateway            -13-                     Version 0.99
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  '3'      - SMF address only
  787.  
  788. These options are mutually exclusive; only one may be in use at a time.
  789.  
  790. The following table provides examples of address conversions with the
  791. MHS to 3+MAIL addressing options:
  792.  
  793.  
  794.                                       -M1           -M2         -M3
  795.  
  796.      John @ Sales                   -Error-      John:Sales  John:Sales
  797.  
  798.      John @ Sales                 JSmith:Sales  JSmith:Sales John:Sales
  799.      {JSmith:Sales}
  800.  
  801.      John @ Sales                JSmith:Sales: JSmith:Sales: John:Sales
  802.      {JSmith:Sales:Corporate}      Corporate     Corporate
  803.  
  804.      None @ 3MAIL                   -Error-      None:3MAIL  None:3MAIL
  805.  
  806.      None @ 3MAIL                  John:Sales    John:Sales  None:3MAIL
  807.      {John:Sales}
  808.  
  809.      None @ 3MAIL                 JSmith:Sales  JSmith:Sales None:3MAIL
  810.      {JSmith:Sales}
  811.  
  812.      None @ 3MAIL                JSmith:Sales: JSmith:Sales: None:3MAIL
  813.      {JSmith:Sales:Corporate}      Corporate     Corporate
  814.  
  815.  
  816.  
  817. In the other direction, 3+MHS Gateway provides the following address
  818. conversions from 3+MAIL to MHS via the -3 option:
  819.  
  820.  'N'      - Name to Name component
  821.  
  822.  'D'      - Domain to Workgroup component
  823.  
  824.  'O'      - Organization to Workgroup component
  825.  
  826.  'S'      - Name:Domain:Organization to Non-SMF component
  827.  
  828. The 'D' and 'O' options are mutually exclusive; only one may be in use
  829. at a time. All other options may be combined for different addressing
  830. resolution.
  831.  
  832. Additionally, the -S option may modify the name and/or workgroup
  833. component of a MHS address. The -SNname option specifies the default
  834. name for MHS addresses if -3N is not in effect. The -SWworkgroup option
  835. specifies the default workgroup for MHS addresses if -3D and -3O is not
  836. in effect.
  837.  
  838. The following tables provide examples of address conversions with the
  839. 3+MAIL to MHS addressing options (assuming -SNnoname and -SWnowork):
  840.  
  841.  
  842.  
  843.  
  844. 3+MHS Gateway            -14-                     Version 0.99
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.                            -3N           -3ND          -3NO
  852.  
  853.         JSmith           JSmith @      JSmith @      JSmith @
  854.                           nowork        nowork        nowork
  855.  
  856.         JSmith:Sales     JSmith @      JSmith @      JSmith @
  857.                           nowork        Sales         nowork
  858.  
  859.         JSmith:Sales:    JSmith @      JSmith @      JSmith @
  860.         Corporate         nowork        Sales       Corporate
  861.  
  862.                                -3S                 -3NS
  863.          JSmith          noname @ nowork     JSmith @ nowork
  864.                             {JSmith }           {JSmith }
  865.  
  866.          JSmith:Sales    noname @ nowork     JSmith @ nowork
  867.                           {JSmith:Sales}      {JSmith:Sales}
  868.  
  869.          JSmith:Sales:   noname @ nowork     JSmith @ nowork
  870.  
  871.          Corporate     {JSmith:Sales:Corpo {JSmith:Sales:Corpo
  872.                               rate}               rate}
  873.  
  874.  
  875.                                -3DS                -3OS
  876.          JSmith          noname @ nowork     noname @ nowork
  877.                             {JSmith }           {JSmith }
  878.  
  879.          JSmith:Sales     noname @ Sales     noname @ nowork
  880.                           {JSmith:Sales}      {JSmith:Sales}
  881.  
  882.          JSmith:Sales:    noname @ Sales    noname @ Corporate
  883.  
  884.          Corporate     {JSmith:Sales:Corpo {JSmith:Sales:Corpo
  885.                               rate}               rate}
  886.  
  887.                               -3NDS               -3NOS
  888.  
  889.          JSmith          JSmith @ nowork     JSmith @ nowork
  890.                             {JSmith }           {JSmith }
  891.  
  892.          JSmith:Sales     JSmith @ Sales     JSmith @ nowork
  893.                           {JSmith:Sales}      {JSmith:Sales}
  894.  
  895.          JSmith:Sales:    JSmith @ Sales    JSmith @ Corporate
  896.  
  897.          Corporate     {JSmith:Sales:Corpo {JSmith:Sales:Corpo
  898.                               rate}               rate}
  899.  
  900. You must select a set of name addressing options that best meets your
  901. particluar needs. Smaller mail systems may be well suited to the
  902. simpler, non-SMF addressing schemes (e.g. -M3 -3ND) and larger, more
  903. complex mail configurations may require the advanced conversion options
  904. (e.g. -M1 -3S).
  905.  
  906.  
  907. 8.5. Addressing MHS Users from 3+Mail
  908.  
  909. Using the DISOSS example, Joe on the DISOSS system can be addressed as
  910. Joe:DISOSS:3Com. Here is how the message is directed to
  911. _GATEWAY:DISOSS:3Com when it is being sent. The following section on
  912. Envelopes, and the section on name expansion in the Theory of Operations
  913. should be read to completely understand this.
  914.  
  915.  
  916.  
  917. 3+MHS Gateway            -15-                     Version 0.99
  918.  
  919.  
  920.  
  921.  
  922.  
  923. The Mail system notices that there is no user named Joe:DISOSS:3Com
  924. registered for 3+Mail. It goes through a sequence of checks to find out
  925. if DISOSS:3Com is a gateway domain. It does this by checking for the
  926. existence of a _GATEWAY:DISOSS:3Com user. If there is one, it builds an
  927. envelope for the server where the gateway user has an inbox.
  928.  
  929. Let's assume that Joe is also the full name of the user on DISOSS. In
  930. this case, the ultimate recipient name in the envelope that is delivered
  931. to the gateway is Joe:DISOSS:3Com. Presumably the gateway code can then
  932. direct the message properly to Joe.
  933.  
  934. Note that since our format for DISOSS user names is the same as 3+Mail
  935. users, it is possible to actually register those users in the Name
  936. Service, as long as they are not registered for 3+Mail server. In other
  937. words, their Mail Server property must be null. It might be desirable to
  938. do this because any user who is registered in the name service can be
  939. included in groups.
  940.  
  941. If the target mail system has more complicated names, either longer than
  942. the 62-character limit of 3+Mail names, or contains characters that are
  943. illegal in 3+Mail names, it can be handled in two different ways. Both
  944. use the curly braces form of naming:
  945.  
  946. 1. The user can simply type in the curly braces:
  947.  
  948.      {oliveb!hplabs!ucbvax!fred}:Unix:3Com
  949.  
  950.  This exact string is passed through to the gateway without the part
  951.  inside the braces being examined in any way by 3+Mail.
  952.  
  953. 2. Fred can be registered in the Name Service. The full mail address can
  954.  be stored as a property for Fred. When Fred:Unix:3Com is addressed,
  955.  3+Mail goes to the Name Service, retrieves his real Unix address, and
  956.  puts it in the envelope.
  957.  
  958. Using the second option means that Fred can be included in groups in the
  959. Name Service, as well as having the advantage that the full Unix address
  960. does not have to be typed each time. It does, of course, require setting
  961. up the Mail Address property in the Name Service, and entering the
  962. addresses for each user who is to be addressed this way. This is
  963. probably to be used only for regular correspondents.
  964.  
  965. There is nothing that requires the contents of the curly braces be only
  966. the address. It can also be used to specify processing options, such as
  967. 4-hour delivery for MCI. The curly braces form is a way that any
  968. information not used by 3+Mail can be passed through 3+Mail to the
  969. gateway.
  970.  
  971.  
  972.  
  973. 8.6. Quick Start Addressing
  974.  
  975.  
  976.  
  977.  
  978.  
  979. 3+MHS Gateway            -16-                     Version 0.99
  980.  
  981.  
  982.  
  983.  
  984.  
  985. 3+MAIL and MHS are not inherently compatible at the addressing level.
  986. 3+MAIL treats the address as an actual address in hierarchial format.
  987. For the most part, MHS treats addresses similarly, but the "workgroup"
  988. component should more appropriately be called a "router".
  989.  
  990. Short of redefining your entire list of user addresses (3+MAIL and MHS),
  991. there are a few addressing schemes you can use with nearly 100%
  992. functionality.
  993.  
  994. On the MHS side, define a gateway to route traffic between 3+MAIL and
  995. MHS. For every 3+MAIL domain you want accessible to MHS users, define "a
  996. workgroup [or host] via an intermediary".
  997.  
  998. For example, define a gateway called 3MHS. To easily access the 3+MAIL
  999. Sales and Support domains from MHS, add the workgroups Sales and
  1000. Support, "Routed via: 3MHS".
  1001.  
  1002. On the 3+MAIL side, define a gateway to route traffic between 3+MAIL and
  1003. MHS. For every MHS workgroup you want accessible to 3+MAIL users, add a
  1004. domain and define an alias _GATEWAY:workgroup that references the MHS
  1005. gateway.
  1006.  
  1007. For example, define a gateway called _GATEWAY:MHS. To easily access the
  1008. MHS Sales and Support workgroups from 3+MAIL, add the domains Sales and
  1009. Support and define the aliases _GATEWAY:Sales and _GATEWAY:Support,
  1010. which reference the _GATEWAY:MHS user.
  1011.  
  1012.  
  1013.  
  1014. MHS users send mail to 3+MAIL users specifying the workgroup/domain and
  1015. non-SMF address. For example, an MHS user would send a message to "Bob @
  1016. Sales { Bob Smith:Sales:Corp }".
  1017.  
  1018. 3+MAIL users send mail to MHS users specifying the workgroup/domain. For
  1019. example, a 3+MAIL user would send a message to "Bob:Sales:Corp".
  1020.  
  1021. This addressing scheme should enable mail access with minimal effort and
  1022. fuss. The flaw with this plan is MHS users sending mail to 3+MAIL
  1023. addresses without specifying the domain component of the 3+MAIL address.
  1024. For example, an MHS user sending a message to "Bob @ Sales { Bob Smith
  1025. }" will cause the message to get kicked around between MHS and 3+MHS
  1026. Gateway. This issue is currently not resolved (and may not even be
  1027. resolvable). Comments and suggestions are welcome.
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041. 3+MHS Gateway            -17-                     Version 0.99
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048. 9. Command Line Options
  1049.  
  1050. 3+MHS accepts the following command line parameters:
  1051.  
  1052.  3MHS  [options]  gateway_host  MHS_temp_area
  1053.  
  1054. where options can be one or more of the following:
  1055.  
  1056.  -?  Help
  1057.      Displays the help screen.
  1058.  
  1059.  -?? Display Settings
  1060.      Displays the current settings.
  1061.  
  1062.  -3[NDOS] MHS->3+MAIL Addressing
  1063.           This option specifies the addressing conversion for 3+MAIL
  1064.           routed to MHS. The switch supports the following options:
  1065.  
  1066.                'N'  Name to Name component
  1067.  
  1068.                'D'  Domain to Workgroup component
  1069.  
  1070.                'O'  Organization to Workgroup component
  1071.  
  1072.                'S'  Name:Domain:Organization to Non-SMF component
  1073.  
  1074.           The 'D' and 'O' options are mutually exclusive; only one may
  1075.           be in use at a time. All other options may be combined for
  1076.           different addressing resolution.
  1077.  
  1078.           See section 8.4 Addressing 3+MAIL Users from MHS for more
  1079.           details.
  1080.  
  1081.  -B  Support Blind Carbon Copy
  1082.      If this option is enabled, 3+MHS will transmit a message for each
  1083.      BCC recipient on 3+MAIL. If disabled, the sender will receive a
  1084.      non-delivery notification from the gateway for each BCC recipient
  1085.      on 3+Mail.
  1086.  
  1087.  -C  Install critical-error handler
  1088.      If this option is enabled, 3+MHS will install its own critical
  1089.      error handler.
  1090.  
  1091.  -D  DaVinci EMail 1.x compatibility
  1092.      DaVinci EMail 1.x does not use MHS header keywords to distinguish
  1093.      between To, Carbon Copy and Blind Carbon Copy recipients. Due to
  1094.      this non-standard implementation, 3+MHS Gateway will falsely
  1095.      recognize Carbon Copy recipients as Blind Carbon Copy recipients.
  1096.      This switch enables 3+MHS Gateway to correctly identify Carbon Copy
  1097.      recipients from DaVinci EMail 1.x. However, Blind Carbon Copy
  1098.      recipients are falsely identified as Carbon Copy recipients when
  1099.      this switch is enabled. You must decide which is preferable for
  1100.      your particular environment.
  1101.  
  1102.  
  1103. 3+MHS Gateway            -18-                     Version 0.99
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.      Unknown if DaVinci EMail 2.x complies with the MHS 1.5
  1111.      specification (and thus would not need this switch).
  1112.  
  1113.  -I  Process Incoming (3+MAIL->MHS) mail
  1114.      3+MHS will process 3+MAIL messages destined for MHS.
  1115.  
  1116.  -L  Usage Log
  1117.      If this option is enabled, 3+MHS records all activity and errors in
  1118.      a log file. The log file is useful for maintenance and
  1119.      troubleshooting. The default log file, 3MHS.LOG, can be changed by
  1120.      the option -Lfilename.
  1121.  
  1122.  -M[1,2,3]     3+MAIL->MHS Addressing
  1123.           This option specifies the addressing conversion for MHS routed
  1124.           to 3+MAIL. The switch supports the following options:
  1125.  
  1126.                -M1  Non-SMF address only
  1127.  
  1128.                -M2  Non-SMF address if available, else SMF address
  1129.  
  1130.                -M3  SMF address only
  1131.  
  1132.           See section 8.4 Addressing 3+MAIL Users from MHS for more
  1133.           details.
  1134.  
  1135.  -O  Process Outgoing (MHS->3+MAIL) mail
  1136.      3+MHS will process MHS messages destined for 3+MAIL.
  1137.  
  1138.  -P  Post-Process Outgoing (MHS->3+Mail) mail
  1139.      3+MHS will process messages destined for 3+MAIL after CMAIL has
  1140.      been run.
  1141.  
  1142.  -Q  Quiet mode
  1143.      If this option is enabled, all video output is suppressed.
  1144.  
  1145.  -S<N|W>d 3+MAIL->MHS 'dummy' values
  1146.           This option specifies the default, or dummy, values used to
  1147.           resolve addressing conversion from 3+MAIL to MHS. The switch
  1148.           supports the following options:
  1149.  
  1150.                -SNd Name component default value
  1151.  
  1152.                -SWd Workgroup component default value
  1153.  
  1154.           See section 8.4 Addressing 3+MAIL Users from MHS for more
  1155.           details.
  1156.  
  1157.  -V[C|M]  Save video display
  1158.           If this option is enabled, the screen display when 3+MHS is
  1159.           executed will be restored on exit. The option -VM is used for
  1160.           monochrome (MDA or Hercules) display modes; use -VC for all
  1161.           other display modes.
  1162.  
  1163.  
  1164.  
  1165. 3+MHS Gateway            -19-                     Version 0.99
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.           WARNING:  This option is not guarranteed to work if display
  1172.           resolutions other than 25x80 text mode are used (e.g. 43/50-
  1173.           line text mode or graphic modes).
  1174.  
  1175.  -Yn Disk buffer size
  1176.      This option specifies the size of the disk buffer (in KB) used for
  1177.      reading messages and copying/moving attachments (disk writes of
  1178.      messages are not affected). Values from 1 thru 32 are valid. Larger
  1179.      buffer sizes improve performance but require more memory.
  1180.  
  1181. Simple (on/off) options are enabled by specifying the switch with an
  1182. optional plus (+) suffix; disabled by a minus (-) suffix, and toggled by
  1183. an asterisk (*) suffix. For example, -C or -C+ enables 3+MHS' critical
  1184. error handler, -C- disables it, and -C* toggles the current setting.
  1185.  
  1186. The following parameters are required by 3+MHS:
  1187.  
  1188.  gateway_host  3+MHS directory (e.g. F:\MHS\MAIL\GATES\3MHS\). This
  1189.                parameter must end with a backslash (\).
  1190.  
  1191.  MHS_temp_area Directory for temporary files created to process incoming
  1192.                mail (e.g. F:\MHS\SW\). This parameter must end with a
  1193.                backslash (\).
  1194.  
  1195. If 3+MHS is launched by the MHS Connection Manager, these parameters are
  1196. automatically appended to the command line.
  1197.  
  1198.  
  1199.  
  1200. 10. Environment Variables
  1201.  
  1202. 3+MHS recognizes the following environment variables:
  1203.  
  1204.    3MHS-OPTIONS
  1205.  
  1206.    This environment variables specifies 3+MHS command line options and
  1207.    is parsed before the 3+MHS command line. For example, the command
  1208.    SET 3MHSOPTIONS=-L -Y16   will enable usage logging and specifies a
  1209.    16K disk buffer, unless modified by the command line.
  1210.  
  1211.  
  1212.    3MHS-GWDIR
  1213.  
  1214.    This environment variable is used if the gateway_host command line
  1215.    parameter is not specified. This variable is useful for standalone
  1216.    (non-MHS launched) operation of 3+MHS.
  1217.  
  1218.    3MHS-TEMPDIR
  1219.  
  1220.    3MHS-TEMPDIR
  1221.    This environment variable is used if the MHS_temp_area command line
  1222.    parameter is not specified. This variable is useful for standalone
  1223.    (non-MHS launched) operation of 3+MHS.
  1224.  
  1225.  
  1226.  
  1227. 3+MHS Gateway            -20-                     Version 0.99
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235. 11. Compatibility Issues
  1236.  
  1237. There are no known incompatibilities at this time.
  1238.  
  1239.  
  1240.  
  1241. 12. Support
  1242.  
  1243. 12.1. Where to Find the Most Current Version
  1244.  
  1245. 3+MHS Gateway will always be distributed to:
  1246.  
  1247.      Ask3Com on Compuserve
  1248.  
  1249.      Novell NetWire on Compuserve
  1250.  
  1251.      Compuer Connections BBS (202-547-2008)
  1252.  
  1253.      The Invention Factory BBS (212-431-1254)
  1254.  
  1255.  
  1256. 12.2. Support for 3+MHS Gateway
  1257.  
  1258. Free support is available to registered users for a period of 90 days
  1259. after purchase.
  1260.  
  1261. Primary support is available via Compuserve. Please send all queries to
  1262. Brian Dluhy at account 70317,2357.
  1263.  
  1264. Phone support is also available to registered users.
  1265.  
  1266. Alternative support channels are being investigated.
  1267.  
  1268.  
  1269.  
  1270. 12.3. Questions
  1271.  
  1272. This space intentionally left blank.
  1273.  
  1274.  
  1275.  
  1276. Appendix A. Error Messages
  1277.  
  1278. This space intentionally left blank.
  1279.  
  1280.  
  1281.  
  1282. Appendix B. 3+MHS Internals
  1283.  
  1284. This space intentionally left blank.
  1285.  
  1286.  
  1287.  
  1288.  
  1289. 3+MHS Gateway            -21-                     Version 0.99
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295. Appendix C. 3MWait - 3+MHS Wait Utility
  1296.  
  1297. This space intentionally left blank.
  1298.  
  1299.  
  1300.  
  1301. Index
  1302.  
  1303. This space intentionally left blank.
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351. 3+MHS Gateway            -22-                     Version 0.99
  1352.